home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / configmail.z / configmail
Encoding:
Text File  |  2001-04-17  |  10.2 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ccccoooonnnnffffiiiiggggmmmmaaaaiiiillll((((1111MMMM))))                                                  ccccoooonnnnffffiiiiggggmmmmaaaaiiiillll((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      configmail - sendmail autoconfiguration script
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////eeeettttcccc////ccccoooonnnnffffiiiiggggmmmmaaaaiiiillll mode [ parameter ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _c_o_n_f_i_g_m_a_i_l is the historic interface to modifying parameters used in the
  16.      sendmail.cf _s_e_n_d_m_a_i_l._c_f file shipped with IRIX to obtain information
  17.      about the local mail environment.  _c_o_n_f_i_g_m_a_i_l can also be executed by the
  18.      user to display and/or modify that information.
  19.  
  20.      _c_o_n_f_i_g_m_a_i_l is no longer the primary way to configure the _s_e_n_d_m_a_i_l._c_f
  21.      file.   The correct way is to modify the _s_e_n_d_m_a_i_l._m_c file.  _c_o_n_f_i_g_m_a_i_l
  22.      can be used to generate a new _s_e_n_d_m_a_i_l._c_f from the information and
  23.      settings in the _s_e_n_d_m_a_i_l._m_c file.
  24.  
  25.      _c_o_n_f_i_g_m_a_i_l can be run in one of several _m_o_d_es.  The _m_o_d_es mmmmcccc2222ccccffff, hhhheeeellllpppp,
  26.      ggggeeeetttt, sssseeeetttt, uuuunnnnsssseeeetttt, and ppppeeeerrrrccccppppuuuu take an additional _p_a_r_a_m_e_t_e_r argument.  The
  27.      remaining _m_o_d_es, lllliiiisssstttt ,,,, mmmmcccc2222ccccffff,,,, mmmm4444 ,,,, and sssseeeettttuuuupppp, take no additional
  28.      _p_a_r_a_m_e_t_e_r argument.
  29.  
  30.      The _p_a_r_a_m_e_t_e_r argument can be one of:
  31.  
  32.      ffffoooorrrrwwwwaaaarrrrddddeeeerrrr      The name of the forwarder host.
  33.  
  34.      rrrroooooooottttddddoooommmmaaaaiiiinnnn     The common domain suffix of all domains to be considered
  35.                     local.
  36.  
  37.      ddddiiiirrrreeeeccccttttddddoooommmmaaaaiiiinnnnssss  The names of all domains for which this host is a relay or
  38.                     exchanger host.
  39.  
  40.      llllooooccccaaaallllddddoooommmmaaaaiiiinnnn    The name of the local domain.
  41.  
  42.      lllloooogggglllleeeevvvveeeellll       The sendmail Loglevel.  Defaults to 1.
  43.  
  44.      ppppaaaatttthhhhaaaalllliiiiaaaassss      The location of the UUCP path-alias database.
  45.  
  46.      rrrreeeellllaaaayyyynnnnaaaammmmeeee      The hostname or alias used for all relay hosts.
  47.  
  48.      rrrreeeeccccssssuuuubbbbddddoooommmmaaaaiiiinnnnssss  Recognized subdomains.  This parameter only has effect
  49.                     when the Gauntlet for IRIX product is installed on the
  50.                     system.
  51.  
  52.      ddddeeeeaaaaddddhhhhoooossssttttssss      The list of all hosts in the local domain that no longer
  53.                     exist or are otherwise permanently unreachable.  Note that
  54.                     the contents of this parameter are actually determined by
  55.                     an external file, /_e_t_c/_s_e_n_d_m_a_i_l._k_i_l_l_e_d, and that the
  56.                     ddddeeeeaaaaddddhhhhoooossssttttssss parameter can only be displayed and not modified
  57.                     via _c_o_n_f_i_g_m_a_i_l.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccoooonnnnffffiiiiggggmmmmaaaaiiiillll((((1111MMMM))))                                                  ccccoooonnnnffffiiiiggggmmmmaaaaiiiillll((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      nnnnuuuummmmccccppppuuuussss        The number of cpus available for sendmail to use.  This
  75.                     value is determined at run time, and can not be set.
  76.  
  77.      The ppppeeeerrrrccccppppuuuu _m_o_d_e takes an argument of a positive intger, and will return
  78.      that value times the value nnnnuuuummmmccccppppuuuussss ....
  79.  
  80.      The default value of each of the above parameters is calculated at
  81.      runtime by _c_o_n_f_i_g_m_a_i_l.  The values thus calculated, when read by the
  82.      autoconfiguring _s_e_n_d_m_a_i_l._c_f file, should result in a working _s_e_n_d_m_a_i_l
  83.      configuration.  It may, however, be necessary to override the calculated
  84.      default values of one or more parameters in some situations.  For this
  85.      purpose, the sssseeeetttt and sssseeeettttuuuupppp modes have been provided.
  86.  
  87.      The sssseeeetttt mode provides an interactive interface through which the user can
  88.      override the calculated default value or change the current override
  89.      setting of the given _p_a_r_a_m_e_t_e_r.  If the user chooses to set a value for
  90.      the parameter that is different from the calculated default, the new
  91.      value is stored in a file with the name /_e_t_c/_s_e_n_d_m_a_i_l._p_a_r_a_m_s.  If the
  92.      value of this parameter is changed as a result of the user's selection,
  93.      _c_o_n_f_i_g_m_a_i_l prompts the user to restart the _s_e_n_d_m_a_i_l daemon so that the
  94.      new value of the parameter is honored.
  95.  
  96.      The sssseeeettttuuuupppp mode takes no _p_a_r_a_m_e_t_e_r argument.  It recursively calls
  97.      _c_o_n_f_i_g_m_a_i_l in the sssseeeetttt mode to obtain settings for the most commonly
  98.      overridden parameters.  It prompts the user to verify and possibly change
  99.      the settings of any other parameters that are currently overridden.
  100.  
  101.      The uuuunnnnsssseeeetttt mode is used to remove any override setting and restore the
  102.      calculated default value of the given _p_a_r_a_m_e_t_e_r.  As with the sssseeeetttt and
  103.      sssseeeettttuuuupppp modes, if the value of the parameter is changed from its previous
  104.      value, _c_o_n_f_i_g_m_a_i_l prompts the user to restart the _s_e_n_d_m_a_i_l daemon so that
  105.      the new value of the parameter is honored.
  106.  
  107.      The hhhheeeellllpppp mode takes a _p_a_r_a_m_e_t_e_r argument and prints the available help
  108.      text associated with that parameter.
  109.  
  110.      The lllliiiisssstttt mode takes no arguments.  It displays the current settings of
  111.      the various configurable parameters plus the values of some internal
  112.      variables.  This mode is intended to be used as a debugging aid.
  113.  
  114.      The mmmm4444 mode is similar to the lllliiiisssstttt mode, but it's output is intended to
  115.      be parsed by the mmmm4444 macro processor.
  116.  
  117.      The mmmmcccc2222ccccffff mode is used to generate a _s_e_n_d_m_a_i_l._c_f file, applying the
  118.      features and settings defined in the _s_e_n_d_m_a_i_l._m_c file.
  119.  
  120.      The ggggeeeetttt mode is used to obtain the current value of the given _p_a_r_a_m_e_t_e_r.
  121.  
  122. WWWWAAAARRRRNNNNIIIINNNNGGGG
  123.      When called from _s_e_n_d_m_a_i_l._c_f, _c_o_n_f_i_g_m_a_i_l must be called in the ggggeeeetttt mode
  124.      only.  The other modes are intended to be used by a human operator.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ccccoooonnnnffffiiiiggggmmmmaaaaiiiillll((((1111MMMM))))                                                  ccccoooonnnnffffiiiiggggmmmmaaaaiiiillll((((1111MMMM))))
  137.  
  138.  
  139.  
  140. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  141.      If an error is detected while running in the hhhheeeellllpppp, lllliiiisssstttt, mmmm4444, or sssseeeettttuuuupppp
  142.      mode, _c_o_n_f_i_g_m_a_i_l places an appropriate error message on standard output
  143.      and exit with a nonzero value.
  144.  
  145.      If an error is detected while running in the ggggeeeetttt mode, _c_o_n_f_i_g_m_a_i_l places
  146.      a null string on standard output and exit with a value of 0.  The ggggeeeetttt
  147.      mode never exits with a nonzero value.
  148.  
  149.      If an error is detected while running in the sssseeeetttt or uuuunnnnsssseeeetttt mode,
  150.      _c_o_n_f_i_g_m_a_i_l places a diagnostic message on standard output and exit with a
  151.      value of 1.  If _c_o_n_f_i_g_m_a_i_l successfully modifies the requested parameter,
  152.      it exits with a value of 2.  If no error is detected, and the parameter
  153.      is unchanged, _c_o_n_f_i_g_m_a_i_l exits with a value of 0.
  154.  
  155. FFFFIIIILLLLEEEESSSS
  156.      ////eeeettttcccc////sssseeeennnnddddmmmmaaaaiiiillll....ccccffff          the _s_e_n_d_m_a_i_l configuration file
  157.  
  158.      ////eeeettttcccc////sssseeeennnnddddmmmmaaaaiiiillll....kkkkiiiilllllllleeeedddd      contains the names of the permanently
  159.                                unreachable hosts in the local domain
  160.  
  161.      ////eeeettttcccc////sssseeeennnnddddmmmmaaaaiiiillll....ppppaaaarrrraaaammmmssss      created and maintained by _c_o_n_f_i_g_m_a_i_l, contains
  162.                                any override settings for the various
  163.                                configuration parameters
  164.  
  165. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  166.      canonhost(1M), m4(1), sendmail(1M).
  167.  
  168.      _I_R_I_X _A_d_m_i_n: _N_e_t_w_o_r_k_i_n_g _a_n_d _M_a_i_l
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.